-- Network Working Group J. Cook, Editor
-- Request for Comments: 1284 Chipcom Corporation
-- December 1991-- Definitions of Managed Objects
-- for the Ethernet-like Interface TypesRFC1284-MIB DEFINITIONS::=BEGINIMPORTSCounter,GaugeFROM RFC1155-SMI
transmission
FROM RFC1213-MIB
OBJECT-TYPEFROM RFC-1212;-- This MIB module uses the extended OBJECT-TYPE macro as-- defined in [13]-- this is the MIB module for ethernet-like objectsdot3 OBJECTIDENTIFIER::={ transmission 7}-- the Generic Ethernet-like group-- Implementation of this group is mandatory for all systems-- that attach to an ethernet-like medium.dot3Table OBJECT-TYPESYNTAXSEQUENCEOF Dot3Entry
ACCESSnot-accessibleSTATUSmandatoryDESCRIPTION"Status information and control variables for a
collection of ethernet-like interfaces attached to
a particular system."
::={ dot3 1}dot3Entry OBJECT-TYPESYNTAX Dot3Entry
ACCESSnot-accessibleSTATUSmandatoryDESCRIPTION"Status information and control variables for a
particular interface to an ethernet-like medium."INDEX{ dot3Index }::={ dot3Table 1}
Dot3Entry ::=SEQUENCE{
dot3Index
INTEGER,
dot3InitializeMac
INTEGER,
dot3MacSubLayerStatus
INTEGER,
dot3MulticastReceiveStatus
INTEGER,
dot3TxEnabled
INTEGER,
dot3TestTdrValue
Gauge}dot3Index OBJECT-TYPESYNTAXINTEGERACCESSread-onlySTATUSmandatoryDESCRIPTION"An index value that uniquely identifies an
interface to an ethernet-like medium. The
interface identified by a particular value of this
index is the same interface as identified by the
same value of ifIndex."::={ dot3Entry 1}dot3InitializeMac OBJECT-TYPESYNTAXINTEGER{ initialized(1), uninitialized(2)}
ACCESSread-writeSTATUSmandatoryDESCRIPTION"The initialization status of the MAC and PLS
(Physical Layer Signalling) subsystems for a
particular interface. The value initialized(1)
signifies that the subsystems for a particular
interface have been previously initialized; the
value uninitialized(2) signifies that they have
not been previously initialized.
Each alteration of an instance of this object to
either of the values initialized(1) or
uninitialized(2) is analogous to an invocation of
the initializeMAC action defined in [9] and has
the effect of (re-)initializing the MAC and PLS
subsystems for the associated interface. In
particular,
all management counters pertaining to the MAC
and PLS subsystems for said interface are
reset to zero;
the receive and transmit layer management
state variables (receiveEnabled and
transmitEnabled in [9]) are set to enable
reception and transmission of frames;
the promiscuous receive function is disabled;
and
multicast reception is disabled."::={ dot3Entry 2}dot3MacSubLayerStatus OBJECT-TYPESYNTAXINTEGER{ enabled(1), disabled(2)}ACCESSread-writeSTATUSmandatoryDESCRIPTION"The operational status of the MAC sublayer for a
particular interface. The value enabled(1)
signifies that the MAC sublayer for said interface
is operational for both transmitting and receiving
frames -- that is, that the value of both the
receive and transmit layer management state
variables (receiveEnabled and transmitEnabled in
[9]) for said interface are true. The value
disabled(2) signifies that the MAC sublayer for
said interface is not operational for either
transmitting or receiving frames. In particular,
the value of an instance of this object is
disabled(2) whenever the value of the
corresponding instance of the dot3Enabled object
is false(2).
Each alteration of an instance of this object to
the value enabled(1) is analogous to an invocation
of the enableMACSublayer action defined in [9] and
has the effect of starting normal transmit and
receive operations (from the ``idle'' state) on
the associated interface. In particular, such an
alteration has the effect of resetting the PLS for
said interface and of setting the receive and
transmit layer management state variables
(receiveEnabled and transmitEnabled in [9]) to be
true.
Each alteration of an instance of this object to
the value disabled(2) is analogous to an
invocation of the disableMACSublayer action
defined in [9] and has the effect of terminating
transmit and receive operations on the associated
interface. In particular, such an alteration has
the effect of setting the receive and transmit
layer management state variables (receiveEnabled
and transmitEnabled in [9]) to be false. Any
transmissions/receptions in progress are completed
before operation is terminated."::={ dot3Entry 3}dot3MulticastReceiveStatus OBJECT-TYPESYNTAXINTEGER{ enabled(1), disabled(2)}ACCESSread-writeSTATUSmandatoryDESCRIPTION"The multicast receive status for a particular
interface. The value enabled(1) signifies that
reception of multicast frames by the MAC sublayer
is enabled on said interface. The value
disabled(2) signifies that reception of multicast
frames by the MAC sublayer is not enabled on said
interface.
Each alteration of an instance of this object to
the value enabled(1) is analogous to an invocation
of the enableMulticastReceive action defined in
[9] and has the effect of enabling multicast frame
reception on the associated interface. Actual
reception of multicast frames is only possible on
an interface when the values for the associated
instances of the dot3MulticastReceiveStatus and
dot3MacSubLayerStatus objects are enabled(1) and
enabled(1), respectively.
Each alteration of an instance of this object to
the value disabled(2) is analogous to an
invocation of the disableMulticastReceive action
defined in [9] and has the effect of inhibiting
multicast frame reception on the associated
interface."::={ dot3Entry 4}dot3TxEnabled OBJECT-TYPESYNTAXINTEGER{ true(1), false(2)}ACCESSread-writeSTATUSmandatoryDESCRIPTION"The transmit layer management state variable
(transmitEnabled as defined in [9]) for a
particular interface. The value true(1) signifies
that the MAC frame transmission is enabled on said
interface. The value false(2) signifies that the
MAC frame transmission is inhibited on said
interface. In particular, the value of an instance
of this object is false(2) whenever the value of
the corresponding instance of the
dot3MacSubLayerStatus object is disabled(2).
Each alteration of an instance of this object to
the value true(1) is analogous to an invocation of
the enableTransmit action defined in [9] and has
the effect of enabling MAC sublayer frame
transmission on the associated interface. In
particular, such an alteration has the effect of
setting the transmit layer management state
variable (transmitEnabled in [9]) for said
interface to be true.
Each alteration of an instance of this object to
the value false(2) is analogous to an invocation
of the disableTransmit action defined in [9] and
has the effect of inhibiting MAC sublayer frame
transmission on the associated interface. In
particular, such an alteration has the effect of
setting the transmit layer management state
variable (transmitEnabled in [9]) for said
interface to be false. Any transmissions in
progress are completed before transmission is
inhibited."::={ dot3Entry 5}
dot3TestTdrValue OBJECT-TYPESYNTAXGaugeACCESSread-onlySTATUSmandatoryDESCRIPTION"The number of 10 MHz ticks which elapsed between
the beginning of a TDR measurement and the
collision which ended it, for the most recently
executed TDR test. If no TDR test has been
executed, or the last TDR value is not available,
this object has the value 0."::={ dot3Entry 6}-- the Ethernet-like Statistics group-- Implementation of this group is mandatory-- Due to implementation restrictions (e.g. in the-- instrumentation provided by a chipset, or a device-- driver), some of the counters in this group may be-- difficult or impossible to implement.-- In such cases, an implementator should apply reasonable
-- best effort to detect as many occurrences as possible.-- In any case, the value of a counter will be the number-- actually detected, which will always be less or equal-- to the number of actual occurrences. In the extreme-- case of a total inability to detect occurrences, the-- counter will always be zero.-- Vendors are strongly encouraged to document in user guides and-- other appropriate documentation the conditions under which the-- values of the counters in this group may represent an-- underestimate of the true count.dot3StatsTable OBJECT-TYPESYNTAXSEQUENCEOF Dot3StatsEntry
ACCESSnot-accessibleSTATUSmandatoryDESCRIPTION"Statistics for a collection of ethernet-like
interfaces attached to a particular system."
::={ dot3 2}dot3StatsEntry OBJECT-TYPESYNTAX Dot3StatsEntry
ACCESSnot-accessibleSTATUSmandatoryDESCRIPTION"Statistics for a particular interface to an
ethernet-like medium."INDEX{ dot3StatsIndex }::={ dot3StatsTable 1}
Dot3StatsEntry ::=SEQUENCE{
dot3StatsIndex
INTEGER,
dot3StatsAlignmentErrors
Counter,
dot3StatsFCSErrors
Counter,
dot3StatsSingleCollisionFrames
Counter,
dot3StatsMultipleCollisionFrames
Counter,
dot3StatsSQETestErrors
Counter,
dot3StatsDeferredTransmissions
Counter,
dot3StatsLateCollisions
Counter,
dot3StatsExcessiveCollisions
Counter,
dot3StatsInternalMacTransmitErrors
Counter,
dot3StatsCarrierSenseErrors
Counter,
dot3StatsExcessiveDeferrals
Counter,
dot3StatsFrameTooLongs
Counter,
dot3StatsInRangeLengthErrors
Counter,
dot3StatsOutOfRangeLengthFields
Counter,
dot3StatsInternalMacReceiveErrors
Counter}dot3StatsIndex OBJECT-TYPESYNTAXINTEGERACCESSread-onlySTATUSmandatoryDESCRIPTION"An index value that uniquely identifies an
interface to an ethernet-like medium. The
interface identified by a particular value of this
index is the same interface as identified by the
same value of ifIndex."::={ dot3StatsEntry 1}dot3StatsAlignmentErrors OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of frames received on a particular
interface that are not an integral number of
octets in length and do not pass the FCS check.
The count represented by an instance of this
object is incremented when the alignmentError
status is returned by the MAC service to the LLC
(or other MAC user). Received frames for which
multiple error conditions obtain are, according to
the conventions of [9], counted exclusively
according to the error status presented to the
LLC."::={ dot3StatsEntry 2}dot3StatsFCSErrors OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of frames received on a particular
interface that are an integral number of octets in
length but do not pass the FCS check.
The count represented by an instance of this
object is incremented when the frameCheckError
status is returned by the MAC service to the LLC
(or other MAC user). Received frames for which
multiple error conditions obtain are, according to
the conventions of [9], counted exclusively
according to the error status presented to the
LLC."::={ dot3StatsEntry 3}dot3StatsSingleCollisionFrames OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of successfully transmitted frames on a
particular interface for which transmission is
inhibited by exactly one collision.
A frame that is counted by an instance of this
object is also counted by the corresponding
instance of either the ifOutUcastPkts or
ifOutNUcastPkts object and is not counted by the
corresponding instance of the
dot3StatsMultipleCollisionFrames object."::={ dot3StatsEntry 4}dot3StatsMultipleCollisionFrames OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of successfully transmitted frames on a
particular interface for which transmission is
inhibited by more than one collision.
A frame that is counted by an instance of this
object is also counted by the corresponding
instance of either the ifOutUcastPkts or
ifOutNUcastPkts object and is not counted by the
corresponding instance of the
dot3StatsSingleCollisionFrames object."::={ dot3StatsEntry 5}dot3StatsSQETestErrors OBJECT-TYPESYNTAXCounter
ACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of times that the SQE TEST ERROR message
is generated by the PLS sublayer for a particular
interface. The SQE TEST ERROR message is defined
in section 7.2.2.2.4 of [12] and its generation is
described in section 7.2.4.6 of the same
document."::={ dot3StatsEntry 6}dot3StatsDeferredTransmissions OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of frames for which the first
transmission attempt on a particular interface is
delayed because the medium is busy.
The count represented by an instance of this
object does not include frames involved in
collisions."::={ dot3StatsEntry 7}dot3StatsLateCollisions OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"The number of times that a collision is detected
on a particular interface later than 512 bit-times
into the transmission of a packet.
Five hundred and twelve bit-times corresponds to
51.2 microseconds on a 10 Mbit/s system. A (late)
collision included in a count represented by an
instance of this object is also considered as a
(generic) collision for purposes of other
collision-related statistics."::={ dot3StatsEntry 8}dot3StatsExcessiveCollisions OBJECT-TYPE
SYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of frames for which transmission on a
particular interface fails due to excessive
collisions."::={ dot3StatsEntry 9}dot3StatsInternalMacTransmitErrors OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of frames for which transmission on a
particular interface fails due to an internal MAC
sublayer transmit error. A frame is only counted
by an instance of this object if it is not counted
by the corresponding instance of either the
dot3StatsLateCollisions object, the
dot3StatsExcessiveCollisions object, the
dot3StatsCarrierSenseErrors object, or the
dot3StatsExcessiveDeferrals object.
The precise meaning of the count represented by an
instance of this object is implementation-
specific. In particular, an instance of this
object may represent a count of transmission
errors on a particular interface that are not
otherwise counted."::={ dot3StatsEntry 10}dot3StatsCarrierSenseErrors OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"The number of times that the carrier sense
condition was lost or never asserted when
attempting to transmit a frame on a particular
interface.
The count represented by an instance of this
object is incremented at most once per
transmission attempt, even if the carrier sense
condition fluctuates during a transmission
attempt."::={ dot3StatsEntry 11}dot3StatsExcessiveDeferrals OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of frames for which transmission on a
particular interface is deferred for an excessive
period of time."::={ dot3StatsEntry 12}dot3StatsFrameTooLongs OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION
"A count of frames received on a particular
interface that exceed the maximum permitted frame
size.
The count represented by an instance of this
object is incremented when the frameTooLong status
is returned by the MAC service to the LLC (or
other MAC user). Received frames for which
multiple error conditions obtain are, according to
the conventions of [9], counted exclusively
according to the error status presented to the
LLC."::={ dot3StatsEntry 13}dot3StatsInRangeLengthErrors OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of frames received on a particular
interface with a length field value that falls
between the minimum unpadded LLC data size and the
maximum allowed LLC data size inclusive and that
does not match the number of LLC data octets
received.
The count represented by an instance of this
object also includes frames for which the length
field value is less than the minimum unpadded LLC
data size."::={ dot3StatsEntry 14}dot3StatsOutOfRangeLengthFields OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of frames received on a particular
interface for which the length field value exceeds
the maximum allowed LLC data size.
The count represented by an instance of this
object is not incremented in implementations that
observe Ethernet encapsulation conventions (by
which the IEEE 802.3 length field is interpreted
as the Ethernet Type field)."::={ dot3StatsEntry 15}dot3StatsInternalMacReceiveErrors OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of frames for which reception on a
particular interface fails due to an internal MAC
sublayer receive error. A frame is only counted by
an instance of this object if it is not counted by
the corresponding instance of either the
dot3StatsFrameTooLongs object, the
dot3StatsAlignmentErrors object, the
dot3StatsFCSErrors object, the
dot3StatsInRangeLengthErrors object, or the
dot3StatsOutOfRangeLengthFields object.
The precise meaning of the count represented by an
instance of this object is implementation-
specific. In particular, an instance of this
object may represent a count of receive errors on
a particular interface that are not otherwise
counted."::={ dot3StatsEntry 16}-- the Ethernet-like Collision Statistics group-- Implementation of this group is optional; it is appropriate-- for all systems which have the necessary meteringdot3CollTable OBJECT-TYPESYNTAXSEQUENCEOF Dot3CollEntry
ACCESSnot-accessibleSTATUSmandatoryDESCRIPTION"A collection of collision histograms for a
particular set of interfaces."::={ dot3 5}dot3CollEntry OBJECT-TYPESYNTAX Dot3CollEntry
ACCESSnot-accessible
STATUSmandatoryDESCRIPTION"A cell in the histogram of per-frame collisions
for a particular interface. An instance of this
object represents the frequency of individual MAC
frames for which the transmission (successful or
otherwise) on a particular interface is
accompanied by a particular number of media
collisions."INDEX{ dot3CollIndex, dot3CollCount }::={ dot3CollTable 1}
Dot3CollEntry ::=SEQUENCE{
dot3CollIndex
INTEGER,
dot3CollCount
INTEGER,
dot3CollFrequencies
Counter}dot3CollIndex OBJECT-TYPE
SYNTAXINTEGERACCESSread-onlySTATUSmandatoryDESCRIPTION"The index value that uniquely identifies the
interface to which a particular collision
histogram cell pertains. The interface identified
by a particular value of this index is the same
interface as identified by the same value of
ifIndex."::={ dot3CollEntry 1}dot3CollCount OBJECT-TYPESYNTAXINTEGER(1..16)ACCESSread-onlySTATUSmandatoryDESCRIPTION"The number of per-frame media collisions for
which a particular collision histogram cell
represents the frequency on a particular
interface."::={ dot3CollEntry 2}dot3CollFrequencies OBJECT-TYPESYNTAXCounterACCESSread-onlySTATUSmandatoryDESCRIPTION"A count of individual MAC frames for which the
transmission (successful or otherwise) on a
particular interface is accompanied by a
particular number of media collisions."::={ dot3CollEntry 3}-- 802.3 Tests-- The ifExtnsTestTable defined in [11] provides a common means-- for a manager to test any interface corresponding to a value-- of ifIndex.-- At this time, one well known test (testFullDuplexLoopBack) is
-- defined in [11]. For ethernet-like interfaces, this test-- configures the MAC chip and executes an internal loopback-- test of memory and the MAC chip logic. This loopback test can-- only be executed if the interface is offline. Once the test-- has completed, the MAC chip should be reinitialized for network-- operation, but it should remain offline.-- If an error occurs during a test, the object ifExtnsTestResult-- (defined in [11]) will be set to failed(7). The following two-- OBJECT IDENTIFIERs may be used to provided more information as-- values for the object ifExtnsTestCode in [11]:dot3Errors OBJECTIDENTIFIER::={ dot3 7}-- couldn't initialize MAC chip for testdot3ErrorInitError OBJECTIDENTIFIER::={ dot3Errors 1}
-- expected data not received (or not-- received correctly) in loopback testdot3ErrorLoopbackError OBJECTIDENTIFIER::={ dot3Errors 2}-- TDR Test-- Another test, specific to ethernet-like interfaces,-- is Time-domain Reflectometry (TDR) which is defined-- as follows:dot3Tests OBJECTIDENTIFIER::={ dot3 6}dot3TestTdr OBJECTIDENTIFIER::={ dot3Tests 1}-- A TDR test returns as its result the time interval between the
-- most recent TDR test transmission and the subsequent detection-- of a collision. This interval is based on a 10 MHz clock and-- should be normalized if the time base is other than 10 MHz.-- On successful completion of a TDR test, the result is stored-- as the value of the appropriate instance of the MIB object-- dot3TestTdrValue, and the OBJECT IDENTIFIER of that instance-- is stored in the corresponding instance of ifExtnsTestResult-- (thereby indicating where the result has been stored).-- 802.3 Hardware Chipsets-- The object ifExtnsChipSet is provided in [11] to identify the-- MAC hardware used to communcate on an interface. The following-- hardware chipsets are provided for 802.3:dot3ChipSets OBJECTIDENTIFIER::={ dot3 8}dot3ChipSetAMD OBJECTIDENTIFIER::={ dot3ChipSets 1}
dot3ChipSetAMD7990 OBJECTIDENTIFIER::={ dot3ChipSetAMD 1}dot3ChipSetAMD79900 OBJECTIDENTIFIER::={ dot3ChipSetAMD 2}dot3ChipSetIntel OBJECTIDENTIFIER::={ dot3ChipSets 2}dot3ChipSetIntel82586 OBJECTIDENTIFIER::={ dot3ChipSetIntel 1}dot3ChipSetIntel82596 OBJECTIDENTIFIER::={ dot3ChipSetIntel 2}
dot3ChipSetSeeq OBJECTIDENTIFIER::={ dot3ChipSets 3}dot3ChipSetSeeq8003 OBJECTIDENTIFIER::={ dot3ChipSetSeeq 1}dot3ChipSetNational OBJECTIDENTIFIER::={ dot3ChipSets 4}dot3ChipSetNational8390 OBJECTIDENTIFIER::={ dot3ChipSetNational 1}dot3ChipSetNationalSonic OBJECTIDENTIFIER::={ dot3ChipSetNational 2}dot3ChipSetFujitsu OBJECTIDENTIFIER::={ dot3ChipSets 5}
dot3ChipSetFujitsu86950 OBJECTIDENTIFIER::={ dot3ChipSetFujitsu 1}-- For those chipsets not represented above, OBJECT IDENTIFIER-- assignment is required in other documentation, e.g., assignment-- within that part of the registration tree delegated to-- individual enterprises (see [3]).END